CAI Commands Help File
@1,Instructional command for PC-CAI "@" At commands
@3,Textual commands for PC-CAI "." Dot commands
@5,Example of Using @Case Command to Make a Menu
@6,Example Uses of Graphics and Animation
@8,What is Shareware
@9,How to Become a Registered User
@10,Association of Shareware Professionals
##1
                            PC-CAI "@" (AT) COMMANDS
                            ------------------------

@BEGIN QUESTION - Marker at first of a question
@CASE - Branch according to user's answer (see example below).
@CHAIN - Being another CAI program. Example:@CHAIN(*PROG2*)
@END QUESTION - End of a question
@ESCAPE - What happens when user presses Esc
@GOTO - Goto a label (@LABEL)
@GOBACK - Go back to top, then search for a label
@GRADE display grade information. 
      EXAMPLE:@GRADE FILE=GRADE.OUT SUMMARY SCREEN
@IF - Branching option. EXAMPLE:@IF GRADE<70 then:POORGRADE
@LABEL - Branching Location
@MENU - Goto DOS .CAI menu
@MON - Detect the type of monitor being used 

(continued)
##2

AT (@) commands continued...
-----------------------------

@OPTION - Controls Esc key. Example:@OPTION ESCAPE:MENU
@READ - User enters an answer
@RESTORE - Sets grading information to zero
@RIGHT (*TEXT*) [KEYWORD,EXACT,EXACT NOCASE,SOUNDEX . . .]
@SHELL (*DOSCOMMAND*) - Execute a DOS command
@STOP - End the tutorial/ optional goto. Example:@STOP GO:LABEL
@TRIES ## - Number of times to allow wrong answers
@WRONG (*TEXT*)
@TRIES ##

##3

                            PC-CAI TEXTUAL COMMANDS
                            -----------------------

.ANIMATE - make up to four images move in sequence
.BLANK ##
.BORDER - create a border. Example:.BORD (*1,1,20,70) double fill
.BOX - Draw a text box. Example:.box(*10,12)/...text.../.endbox
.CENTER (*text*) - center text
.CIRCLE - craw a circle
.CLS or .CLEAR - CLEAR SCREEN. Example: CLS C=176 
(.CHR###) - display an ASCII character. Example:(.CHR222)
.COLOR - set monitor color
.DRAW - draw lines in graphic mode
.GET - Get an image into memory
.INFORMATION ## (*text*) CONDITIONAL - collect information from response
     also (.); .INF 11=Number RIGHT, 12-WRONG, 13-PERCENT RIGHT
     Example: (.INF 1), you got (.INF 11) questions right!

(continued)

##4
DOT commands continued...
-------------------------

.FUN - Define meanings for function keys. Example .FUN1 = GO:label
.LINE (x,y)-(x,y)
.LOCATE y,x - locate cursor on the screen at y,x
.MOVE - move a single image around the screen
.PAINT - fill an graphic image with a color
.PALETTE - choose graphic color palette
.PAUSE (*PROMPT*) - pause until Enter is pressed
.PCX name x,y - Display a PCX (Paintbrush graphic)
.PLAY (*designation*) ... plays music
.PSET - Place graphic pointer on screen
.RECORD (*TEXT*) FILE=outfile ... records answers
.REM - Remark
.SKIP ##
.USE  - PROG=progname ... temporarily use another file
.VIEW - view contents of ASCII file. Example:.VIEW (*myfile.txt*)
    also, (~15,3~) - change color in text to 15,3
.WAIT # - wait # seconds


##5
                    EXAMPLE OF USING @CASE TO CREATE A MENU
                    ---------------------------------------
                                                                               
@CASE(*ABCD:PCX,ANIM,MOVE,END*) center border
  A - Show A Sample PCX Graphics File
  B - Show a Sample Animation
  C - Show Sample Move
  D - End This Program
@END
.pause
@LABEL:PCX
...place commands here
@LABEL:ANIM
...place commands here
@LABEL:MOVE
...place commands here
@LABEL:END
.locate 24,1
.pause (*Press Enter to End this Program*)
@STOP menu

##6

                      EXAMPLES OF USING GRAPHICS COMMANDS
                      -----------------------------------
                                                                               
EXAMPLE DISPLAY PCX GRAPHIC
---------------------------
.screen 1
.cls
.pcx pcxtest.pcx 1,2


EXAMPLE MOVE
-------------
.screen 1
.cls
.locate 20,1(*Example Moving Single Image*)
.get runner1
.move (1,100)-(250,100)
.locate 20,1 (*                            *)
.locate 20,1
.pause


##7

                               EXAMPLE ANIMATION
                              ------------------
                                                                               
.SCREEN 1
.cls
.locate 20,1 (*Example Animation*)
.line (1,130)-(155,95)
.line (155,95)-(315,130)
.line (1,130)-(315,130)
.LOAD RUNNER1,RUNNER2,RUNNER3,RUNNER4
.ANIMATE (1,100)-(150,60) STEPX=4 STEPY=-1 PAUSE=.1
.ANIMATE (150,65)-(300,130) STEPX=4 STEPY=1 PAUSE=.1
.locate 20,1 (*                              *)
.locate 20,1
.pause
##8
                               S H A R E W A R E
                               _________________


                            TRY IT BEFORE YOU BUY IT

The purpose of shareware products is to allow you to try software products
before you buy them.  PC-CAI is not a public domain program, it is fully
copyrighted. Persons who use PC-CAI beyond "trying it out" should purchase a
copy. You receive several benefits from becoming an official registered user:

1. You are officially licensed to use the program.
2. You help to keep the product growing to meet your needs.
3. You receive the very latest version, with a printed, bound, and expanded
manual.
4. You receive periodic newsletters announcing new releases, and pointing out
important information on any bugs and fixes.
5. You are able to purchase update to new versions for a reduced cost.

See the next screen on "How to Register" . . .
##9

                        HOW TO BECOME A REGISTERED USER
                        -------------------------------


Print out the file on disk named ORDER, fill it out and mail it directly to
TexaSoft. To print this file, you can use the command:

COPY ORDER LPT1:

or

PRINT ORDER

To purchase by phone, call 214-291-2115 during business house (Central Time).
Please have your MasterCard or Visa handy. Corporations, schools and
governmental bodies may order with a purchase order. Organizational quantity
discounts and site licenses are available.

                              ---Order Today!---

##10

                           ┌─────────┐
                     ┌─────┴───┐     │              (tm)
                   ──│         │o    │──────────────────
                     │   ┌─────┴╨──┐ │  Association of
                     │   │         │─┘  Shareware
                     └───│    o    │    Professionals
                   ──────│    ║    │────────────────────
                         └────╨────┘    MEMBER

TexaSoft is a member of the Association of Shareware Professionals (ASP).
ASP wants to make sure that the shareware principle works for you.  If you
are unable to resolve a shareware-related problem with an ASP member by
contacting the member directly, ASP may be able to help. The ASP Ombudsman
can help you resolve a dispute or problem with an ASP member, but does not
provide technical support for members' products.  Please write to the ASP
Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve message
via Easyplex to ASP Ombudsman (70007,3536).

